home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 16 / Mac Magazin and MacEasy Magazine CD - Issue 16.iso / Utilities / FolderCompare u1.0b3 FAT / Folder Compare ReadMe < prev    next >
Text File  |  1995-11-18  |  8KB  |  110 lines

  1. Folder Compare
  2. © Michel Pollet, 1995
  3.  
  4. That program is Shareware :
  5. You can send me your $15 (Cash Only):
  6. Michel Pollet
  7. 2 Allée des Tilleuls
  8. Résidence de l'Ermitage
  9. 92330 Sceaux
  10. France
  11. Email: michel@ellis.fdn.org
  12.  
  13. Folder Compare is a tool for manipulating directories that change. I wrote it mainly for comparing big source folders when several people work at the same time on them. You can also use that program for comparing document folders if you want, or even synchronize folders from your powerbook with your desktop machine.
  14.  
  15. Why that program ? Many a program can synchronize folders…
  16. Well, yes, BUT Folder Compare is more powerfull than that because it let you choose what to do with the diferences. You're not always expected to UPDATE a folder, you may want to restore a copy of a file for example. Folder Compare allows you to do that, and more !
  17.  
  18. How to use ?
  19. Easy: just launch the application. A window will appears with two drop place on top. Drag & drop your SOURCE (the folder you've been working on) and COMPARE folder from the finder to the specified places, and click the 'Compare' button.
  20. The comparison runs in the background, but moving files/folder from one or the other folder while you're comparing it would be a bad idea, don't you think ?
  21. You can STOP the comparison by clicking the 'Compare' button again.
  22.  
  23. What are the four lists used for ?
  24. • 'Unique in source' list contains the files or folder that are only in the SOURCE Folder. Typically files/folder that you've added to the SOURCE folder, or that have been removed from the COMPARE folder.
  25. The list displays the icon and filename of the file, and the name of it's parent folder. 
  26. • 'Unique in compare' list contains the reverse. ie: the files/folders that are exists only in the COMPARE folder. The display is the same as in the 'Unique in source list'
  27.  
  28. Tip: In each lists, you can click (and hold) the mouse on the file/folders little icons to display a popup with the complete name (pathname) of the file/folder. If you are comparing folders on a slow disk (a server), the popup may take sereval seconds to appears.. so hold on :-)
  29.  
  30. The buttons at the bottom of those two lists are :
  31. Open: open the selected files using the application that created it. If it's a folder, it opens the folder in the finder.
  32. Trash: will move the selection to the trash. BE CAREFUL, there's NO WARNING.
  33. Get Infos: will act like the 'Get Infos' menu from the finder.
  34. Open Enclosing: will open the enclosing folders of the selected items in the finder.
  35. Install: will copy the file/folder from the current folder (SOURCE if you are in the Unique in source list, COMPARE if you are in the Unique in Compare list) to the other folder, at the same location relative location, WITHOUT WARNING.
  36.  
  37. • 'Different' list shows files that are present in both folders, but are different. The criteria are :
  38. + Modification date
  39. + Size 
  40. + Change in the Type or creator of the file
  41. The display shows the filename, the enclosing folder, and the difference found. 
  42. Note that the file displayed in the list is always the file from the SOURCE folder, so if the label says 'Newer' it means that the file in the SOURCE folder is newer than the other. Keep that in mind when you decide to update files.
  43.  
  44. The buttons at the bottom of that list are:
  45. Open Both: Will open both files (when I mean both, that's the file from the SOURCE folder, and it's counterpart in the COMPARE folder) using the application that created them.
  46. Get Info Both: Open the two Infos Windows in the finder, for both files/folders.
  47. Install Source: Will copy the file from the SOURCE folder to the COMPARE folder, at the same relative location, and trash the file from the COMPARE folder.
  48. Restore Compare: Will do the same, but the other way around (from the COMPARE to the SOURCE folder)
  49.  
  50. • 'Moved' list shows file/folders that MAY have been moved from one place to another. How do I know ? I look at the 'Unique in source' folder and if I find there a file and has the same name of one in the 'Unique in compare' list, I decide that that file has been moved. It works correctly most of the time, but that feature can of course be fooled rather easilly. So look at the content before replacing anything.
  51. The display shows the filename and parent folder from the SOURCE folder, and it's relative location in the COMPARE folder.
  52.  
  53. The buttons are:
  54. Open Both/Get Info Both: does the same as the Different List.
  55. Move Source: will move the file/folder from the SOURCE folder to the same relative location as the one in the COMPARE folder. Note that you should compare again after moving items, because the file/folders may still be different.
  56. Move Compare: does the same, but in the COMPARE folder.
  57.  
  58.  
  59. The Log Window
  60. The log window (from the Windows menu) displays the log of the file opperations you're making. It displays only when you trash/copy/move files. You can copy the log window to mail to your coworkers for them to know what you've been updating.
  61. Everytime you make an operation on a selection, the selection disable itself to prevent you of doing doing them again. You should compare the folders again to verify that everything is fine.
  62.  
  63. Now, the funny things
  64. In the same folder as Folder Compare, you'll find a script named "Folder Compare Script". Folder Compare NEED that script for running, but the funny thing is that it use that script for doing all it's finder oriented opperations. So you can customize it if you want !! (Open it with AppleScript's Script Editor)
  65.  
  66. The not-so-funny things
  67. Folder Compare is not completly finished, you MAY have crash (I did'nt find any, but who knows) and you ABSOLUTLY NEED:
  68. + AppleScript
  69. + The Drag Manager
  70. + A Scriptable finder running.
  71. If you have a plain System 7.5 installed, everything will be fine.
  72. + There are time when you may receive funny error messages, If you want to help, just mail them to me.
  73.  
  74. Future improvments
  75. If I receive enougth payment, I plan of doing a real source control system (like cvs under UNIX) with a complete text compare utility, a list of helpers applications for opening/comparing files and a lots of other things ! 
  76.  
  77. Your money !!
  78. Folder Compare is Shareware. That means you're expected to send me $15 (cash ONLY, no checks) if you use the program. That's not because you got that program from somewhere without paying (or even if you paid for it, that's your fault) that that mean you don't have to pay me. 
  79. I'm trying to earn at least part of my money by doing sharewares, I'd really like people to pay me. I did'nt have good experience with my previous shareware (especially with the French people, who are'nt very honest (you french don't scream : I AM french)).
  80. When you register, you'll get the latest version by Email, and that version will not have the bothersome about dialog at startup.
  81.  
  82. You can send me your $15 (Cash Only):
  83. Michel Pollet
  84. 2 Allée des Tilleuls
  85. Résidence de l'Ermitage
  86. 92330 Sceaux
  87. France
  88. Email: michel@ellis.fdn.org
  89.  
  90. Release Notes:
  91. 1.0b3
  92. + Fixed a little hiliting bug.
  93. + Removed the flickering of the lists.
  94. + List elements are not disabled before executing events, but after.
  95. + I use the time I steal from the unregistered user at startup more wisely.
  96. + Double clicking a list element either 'open' or 'open both' it, depending of the context.
  97. + First public release.
  98.  
  99. 1.0b2
  100. + Added a spinning cursor when AppleScripting, with a command period cancel option.
  101. + Compiled using 604 sheduling, and PowerPC alignment (a lot faster, even on 601)
  102.  
  103. 1.0b1
  104. + First release to beta testers
  105.  
  106. Disclaimer
  107. Folder Compare does'nt ask conformation about potentially destructive opperations, you have to know what you are doing. I strongly suggest that you learn to use Folder Compare on copies of your folders before starting doing real work with it. I will not be held responsible for any loss of datas that may occur !
  108. I wrote that program, but I'm still careful when using it !!
  109. Remember that if you click the wrong button, especially when copying files, Folder Compare uses the 'duplicate' finder event for doing those. It means that the files you replace will go in the trash, and you may still restore it.
  110.